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rev. 1.2 Changed Start sound can. 
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Added Sound tools status call for sound tools starftip call 
Added individual generator status can. 
rev. 1.3 Updated tte Start Sound call to include die new parameter 
block. 

Added FFSoundDoneStatus function ($14). 

rev. 1.4 Changed the Frequency formula in the FFStartSound call to use integer values 
instead of floating point values, fee the frequency register calculations. 

Changed the descriptions in the low level routines to access the DOC registers or 
ram. 

rev. 1J Updated the G«ierator/Mode wad parameter in the FFStartSound call, 
rev. 1.6 Changed the paramexter block format for the FFStartSound caU to conform with 
the wad aligment of parameters passed to functions. 

Reserved osdUators thirty and thirty ate fa use by Apple Computer. These two 
oscillators can NOT be used by application programs, 
rev. 1.7 Updated stop sound call to show 1 » stop corresponding generator. 

Added examples fa each of the Sound Tools function calls. 
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1.0 Introduction. 

The sound tool package gives developers the ability to access 
the Sound hardware without having to know specific hardware 
I/O addresses. The Cortland sound hardware comes in two 
configurations. The first configuration is 100% compatible 




applications toggle a soft switch, which in turn generates 
clicks in a speaker. Also, with Cortland it is possible for an 
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The DOC ram is used to store waveforms which will b© used by the 
DOC for sound generation. The DOC is the work horse of the sound system. 
With this chip we can create sounds of any pitch and duration. A register 


breakdown of the DOC follows: 
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DOC register table 
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Please refer to the Ensoniq DOC Ers for a detailed description of the part. 

The analog section contains all the circuitry needed to amplify and 
filter the signal coming from the Sound Glu or the DOC, which will be sent 
to the speaker. 

Finally, the sound connector gives developers the ability to design 
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interface cards, which can take the tones generated by the DOC and modify 
them further. Two examples of possible sound cards are, programmable 
filter stereo interface cards, and sound sampling cards. The remainder of 
this document will deal with a detailed description of the Sound tool calls 
and how they can be used to access the hardware to generate sounds. 
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1.1 Sound Tools Definitions. 

An oBcillator is defined as the basic sound generating unit in the DOC. 
The DOC contains thirty two oscillators; each of which can function 
independently from all the other oscillators. 

One of the modes the DOC can be set to is called swap mode. In this 

mode each pair of oscillators is grouped together to form a swap pair of 

oscillators. This is the mode used by the Free Form synthesizer to generate 
sounds. Each of these swap pair of oscillators is called a Generator. There 
are fifteen generators defined in the Cortland sound system. Oscillators 
thirty and thirty one a reserved for use by Apple Computer and should not be 
used by application programs. An oscillator to generator translation table 
has been defined to get the generator number corresponding to a particular 
oscillator number. 

Before a generator can be accessed, a sound tools startup call must be 
made. This call assigns a work area for the sound tools. The work area is 
broken down into sixteen groups of sixteen bytes each. Each sixteen byte 
group is defined to be a generator control block (GCB). The first byte of 
each GCB is defined to contain the synthesizer mode being used by that 

generator. The low nibble of the byte contains the mode. The high nibble is 

reserved for use by the system. The remaining fifteen bytes are user 
definable. 

The Sound tools set is made up of four main blocks; the Free Form 
Synthesizer, the Note Synthesizer, the Note Sequencer and the Instrument 
generator. 
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1.0 Free form synthesizer tool set definition. 

As mentioned before, the tool set gives a developer the ability to 
control the sound hardware without having to access the hardware registers 
directly. The tool set is defined from the point of view of a complete sound 
system. The tool set must be able to read and write to ram, read and write 
to the DOC registers and raise and lower the volume. 

The sound tool package is accessed through the Tool locator. This 
tool locator lets an application set up parameter lists on the stack, call tool 
functions and return to the caller with return parameters on the stack. It is 
the responsibility of the caller to make room on the stack for values which 
may be returned to the caller from the tool calls. 

The Sound Tool set has a tool number assigned to it. With this tool 
number the Tool Locator can access the sound tools. 

The sound tool calls are broken down into two groups. The first group 
of calls is made through the Tool Locator. Each of these calls has a function 
number assigned to it. With this function number the Tool locator knows 
which function to call within the tool set. All parameters for these calls 
are passed on the stack. Function results are returned to the caller in the 
stack. The number of parameters will vary depending on the type of call 
being made. It is the responsibility of the individual tool functions to do 
the stack manipulation to keep it aligned. Also the accumulator and the 
carry bit will reflect the success or failure of the function call. Please 
refer to the Tool locator" documentation for a detailed description of the 
interface. 

The second group is a set of routines which can be accessed through a 
jump table located somewhere in ram. Parameters are passed to these 
routines in the processors registers. Results from these calls are passed 
back in registers. The following list gives a breakdown of the sound tools. 
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Sound tool function calls: 
Groyp A (Function calls) 

^ ^ ^ At Mn. 1A fn A 


SoundBootlnit - $01 
SoundStartup - $02 
SoundShutdown »$03 
SoundVersion ■ $04 
SoundReset - $05 

SoundToolStatus - $06 
WriteRamBlock - $09 
ReadRamBlock - $0A 
GetTableAddress - $0B 
GetSoundVolum© »$0C 
SetSoundVolume ■ $0D 
FFStartSound - $0E 
FFStopSound - $0F 
FFSoundStatus - $10 
FFGeneratorStatus - $11 
SetSoundMIRQV - $12 
SetUserSoundIRQV - $13 


FFSoundDoneStatus- $14 


Read Register 
Write register 
Read Ram 
Write Ram 
Read Next 
Write Next 


*• The low level routines are entered through a jump table. The table address can be obtained 
through a call to "Get Address” function. The format of the jump table is as follows: 


Offset 


Read Register $00 
Writs Register $04 
Road Rom $08 
Write Ram $0C 
Read Next $10 
Write Next $14 
©actable $18 
Generator table $1C 
Geb.addr. table $20 


1 Addr low 

Addr high 

Bank 

$00 

jm523K23BBl 


Bank 

$00 1 

Addr low 

Addr hiah 

Bank 

$00 

Addr low 

Addr high 

fjank 

$00 

Addr low 

Addr high 

Bank 

$00 

i Addr lew 

Addr high 

Bank 

$00 

1 Addr low 


Bank 

$00 

Addr low 

Addr high 

Bank 

$00 

1 IZfP 


Bai’nr - 

$00 
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SfluMBflfllMi fAm ^Lian__#Qi 

This call is made on system powerup or system reset to bring the 
sound hardware to powerup state. The call is made by the firmware and can 
NOT be made by an application program I This call will reset all of the DOC 
sound memory to $80, zero out the sound tools work areas, halt all the 
oscillators and turn the volumes down to zero. 

Error Codes: None 
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SmmdSlartiip- 

The Sound tools startup call is made by an application to set up a 
sound tools work area. This call must be the first call made by the 
application program. The call initializes a work area to be used by the 
sound tools. The pointer to the work area must be passed as a parameter to 
the call. This work area will be used as a zero page. This page will be 
allocated by calling the memory manager. It must be page aligned and 
locked until a shutdown call is made. The stack configuration for the call is 
as follows: 


Stack configuration for SAppInit 
Wap word ; Work area pointer in Bank $00 


Error Codes: 

$10 « No DOC chip found 

$18 - Sound tools already started 

Example: 

PEA Label ; One page work area in bank $00 
_SoundStartup ; Sound Tools startup macro call 
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SmialSAuMmiii funclion #03 

This call will shut down the sound tools. It shuts off all of the 
oscillators resets the WAP back to $0000 and zeros out the sound tools 
work memory to zero. There are no parameters passed to the call on the 
stack and no values returned It is the responsibility of the application to 
relase the memory allocated to the work area back to the memory manager. 

Error Codes: None 
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SfluMJteaiaa function #04 

This call returns the Sound tools version number. The format of the 
version number is as specified in the Tool Locator documentation. There are 
no parameters passed to the call but room must be made on the stack for one 
word of version information returned to the caller. 

Error Codes: None 

Example: 

PEA $0000 ; make room for version 

_SoundVersion ; Sound Tools version call 
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This call stops all of the generators which may be generating sound. 
This call can not be used by an application to stop sound generation. It is 
intended for use by the firmware to control the shutdown of generators. An 
application program should use the stop sound call to shut down a 
generator. This call does not require any parameters on the stack or returns 
any values back to an application. This call does not update the active 
generators flag. 

Error Codes: None 


Sound Tools ERS Rev. 1.7 June 26, 1986 12:15 PM Confidential 


page 13 



SoundToolStatus fiiodiIai3-_tQ,6 

This call will return the status of the sound tools. It returns a $FFFF 
if a SAppInit ($02) call has been made; otherwise it returns $0000. Room 
must be made on the stack for a one word value which will be returned to 
the caller. 

Error Codes: None 

Example: 

PEA $0000 ; make room For sound tools status 

_SoundToolStatus ; Sound Tools Started status 
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WnMRam,m.mK 

The Write Ram Block call will write a specified number of bytes from 
system ram into DOC ram. The parameter list is made up of the starting 
address, and a byte count to move. If the sum of the starting address and 
the byte count are greater than 64K, an error status will be returned. 


Stack configuration for write 
Source_ptr:Long word 
DOC.start:word 
Byte_count:word 


ram block: 

; data source start address 
; DOC buffer start address 
; number of bytes to move 


Error Codes: 

$0011 - DOC address range error. 


Example: 

Pushlong Label 
PEA DOC.buff 
PEA byte.count 
WriteRamBlock 


; Source buffer address 
; DOC ram buffer start address 
; number of bytes to move 
; Write ram block macro call 
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BeadBamBMak. function #oa 

This call reads any number of locations from the 64K DOC ram area 
into a user specified buffer. The number of bytes and the starting location 
must not add up to a value greater than 64K, otherwise a range error will be 
generated. The format of the parameter list is as follows: 

Stack configuration for Read Ram block 

Dest_ptr:Long word ; Destination system buffer address 
DOC.start:word ; Source start address in DOC ram. 

Byte_count:word ; number of bytes to move 

Error Codes: 

$0011 - DOC address range error. 


Example: 

Pushlong Label 
PEA DOC.buff 
PEA byte.count 
ReadRamBlock 


; System ram buffer start address 
; DOC ram buffer start address 
; number of bytes to move 
; Read ram block macro call 
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GfillabteAddEgas msUmMB, 

This call returns the jump table address for the fast access routines. 
The table of low level routines is defined as follows: 

Offset 

Read Register $00 
Write Register $04 
Reed Ram $08 
Write Rem $0C 
Read Next $10 
Write Next $14 
Osctable $18 
Generator table $10 
Gcb.addr. table $20 


Addr low 

Addr high 

Bank 

$66 

Addr low 

Addr high 

Bank 

soo 

Addr low 

Addr high 

Bank 

r $00 

Addr low 

Addr hiah 

Bank 

$00 

Addr low 

Addr hioh 

Bank 

soo 

Addr lew 

Addr high 

Bank 

soo 

Addr low 

Addr high 

Bank 

$00 

Addr lew 

Addr high 

Bank 

$66 


TOflSp 

tsanK 1 

SOO 


With the exception of the last three entries, each of these routines 
are defined later in this document. 

The Osctable translates from generator number to oscillator number, 
. The oscillator number returned through this table is the first oscillator of 
the pair. The Gcb address table points to the first location of the GCB 
corresponding to a generator, and the Generator table translates from 
oscillator number to generator number. 

The application making this call must make room on the stack for a 
long word returned from the call. 

Error codes:None 
Example: 

Pushlong $00000000 ; Make room for long address 

JSetTableAddress ; Get table address macro call 


Sound Tools ERS Rev. 1.7 June 26, 1986 12:15 PM Confidential 


page 17 




GetSound Volume £UD£Um^M£ 

This call will read the volume setting for a generator. The possible 
range of values read back are between $00-$FF. All eight bits are valid for 
DOC volume registers. 

If the generator specified is greater than fourteen ($0E), then the 
system volume setting will be returned. The hardware for the system 
volume control uses the low nibble of a byte to set the volume. In order to 
be consistent with the DOC volume registers, we map the low nibble into the 
upper nibble of a byte. We end up with each possible system volume setting 
mapped sixteen times. Volume settings $00-$0F correspond to system 
volume setting $00, values $10-$1F correspond to system volume $01, etc. 

Room must be made on the stack for a one word value which will be 
returned from the call. 

Stack configuration for Get Volume call: 

Gen_number:word ; Generator number 

Error codes:None 
Example: 

PEA $0000 ; room for volume setting 

PEA gen.num ; Generator number 
_GetSoundVolume ; Get volume macro call 
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SjBlSflmdMMiAmfi. Function sod 

The set volume call changes the volume setting for the volume 
registers in the DOC and the system volume. Generator numbers $00-$0E 
will set the volume on pairs of generators in the DOC. Generator numbers 
$0F or greater will set the system volume control. The range of values for 
the volume setting are $00-$FF. The DOC volume registers use all eight bits 
of resolution. The system volume control will use the upper nibble of the 
setting to determine the setting. 


Stack configuration for SetVolume call: 

Volume_setting:word ; new volume setting 

Gen_number:word ; Generator number to set 

Error codes: None 


Example: 


PEA New.volume ; new volume setting 

PEA gen.num ; Generator number 

_SetSoundVolume ; Get volume macro call 
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EmiMIml .-.Mi. 

This call will enable the DOC to start generating sound on a particular 
generator based on the parameter list passed to the call. If a generator is 
already active and a start sound call is made for it, then the previous sound 
generation process will be terminated and the new sound process will be 
started. The parameter list for the Start Sound call is as follows: 


The stack configuration for StartSound call: 

GenNumb./FFsynth:word ; Channel no^generator number/mode 





__ 1 _ 

eff- 




11,1 

IQX3XXIX] 


OOC channel number ($0*$F) 
■Generator number ($0-$E) 
■Reserved (must be $0) 
■Synthesizer mode ($0-$F) 

FFSynth - $01 


b15 


bO 


Pblock _ptr:Longword 
The parameter block format: 
Wsve„start:Lengword 
Wave„size:werd 
Fr@q_offset:word 
DOC^bufferrwerd 
DOC_buffer_size word 
Nextw„addr±ongword 
Volume.settingword 


; Parameter block pointer 

; Start address of wave 
; Waveform size in pages 1 
; waveform playback frequency 2 
; DOC buffer start address 4 
; DOC buffer size code 3 
; Next wave parameter block ptr 5 
; DOC volume setting. 4 


1. The smallest which can be played back is one page. A waveform size of 

IFFFF will play back 65536 pages. 

2. The Frequency register setting can be calculated with the following 
formula: FR-((32*PF)/1645), where PF-Playback frequency in hertz 
& FR-Frequency register value. 

3. This code assigns a size for the DOC buffer used for the waveform being 
played. One of these buffers is assigned for each oscillator in the 
generator pair being used to play the waveform. The DOC start address 
for the second oscillator is assigned at start address + DOC buffer size. 

4. For further information on these settings, please refer to 
ttie Ensoniq DOC ERS. 

5. These three bytes point to another waveform parameter block. If the 

setting of the Nextw„addr and N#xtw_bank are zero, then there are no 
more Free-Form synthesizer waveforms to be played back through this 
start sound call. 


Error Codes: 

$0012 - NO SAppInit call made 
$0013 - Invalid generator number 
$0014 - Synthesizer mode error 
$0015 - Generator busy 
$0017 « Master IRQ not assigned 
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Example: 


Pblock 


Next.wave 


PEA Gen.mode 
Pushlong Pblock 
FFStartSound 


Generator/mode word 

Parameter block pointer 

Free Form Synth start sound macro 


tqu 4 

DC 14’Wave.starf 
DC 12’Wave.size’ 

DC 12’DOC.Freq' 

DC IZDOC.buffer* 
DC 12'DOC.buf.eode' 
DC 14'Next.wave' 

DC 12’DOC.volume’ 


Waveform parameter block 
Waveform start address 
Wave size in pages (1 page min.) 
DOC frequency register value 
DOC ram buffer start address 
DOC buffer size code $00-$07 
next wave parameter block ptr. 
DOC volume register setting 


equ * ; Next wave parameter block 
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This call will stop sound generators which may be running. A 
generator running is defined to be one playing a waveform or one which has 
completed playing a waveform. The generator will stay busy until a stop 
sound call is made, even though waveform playback has ended. Depending on 
the setting of a sixteen bit flag passed as a parameter to the function any of 
fifteen generators will be stopped if running. Each bit position in the stop 
generator mask corresponds with a sound generator. Bit zero corresponds to 
generator zero, bit one corresponds with generator number one, and so on. 
There are only fifteen generators defined. This call does not return any 
error information back to the caller. The format of the parameter list is as 
follows: 


Stack configuration for Stop Sound: 

Gen„mask:word ; generators to stop 

STOP SOUND MASK 

0 I El D|C IB |a I 9 I 8| 7 |6 |5 | 4 I 3 I 2 I 1 I 0 


Generator #0 
Generator #1 
Generator #2 
Generator #3 
Generator #4 
Generator #5 
Generator #6 

g enerator #7 
enerator #8 
Generator #9 
Generator #A 

g enerator #B 
enerator #C 
Generator #D 
Generator #E 


Must be zero 


stop corresponding generator 
leave it generator alone 


Error Status: None 
Example: 

PEA Stop.mask ; mask for stop generators 
_FFStopSound ; Free Form Synth stop sound 
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EFSmmrfSlatua 

This call will return the status of the all fifteen generators. Any bit 
position in the status word returned from the function call signifies that 
the corresponding generator is active. There are no parameters passed to 
the function. The format of the word returned form the call is as follows: 


Generators status word 


0 

E 

D 

C 

B 

A 

9 

8 

7 

6 

5 

4 

3 

2 

1 


JJJT # 




g enerator #0 
enerator #1 
Generator #2 
Generator #3 
Generator #4 
Generator #5 
Generator #6 

g enerator #7 
enerator #8 
Generator #9 
Generator #A 

g enerator #B 
enerator #C 
Generator #D 
Generator #E 


Must be zero 


1 - Generator is assigned/busy 
0 - Generator free 


Error Status: None 
Example: 

PEA $0000 ; make room for status word 

_FFSoundStatus ; Generators status macro call 
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EEfigag mteJtS -l a, tMg„ EumLjelMn=M_t 

This call will read the first two bytes of the GCB corresponding to 
the generator specified. Room must be allocated on the stack for the word 
returned from the call. For the Free form synthesizer these two bytes have 
the following format: 

_ $01 - Last block of 

wave loaded. 

$00 - Gen. available 

- —$01 . Free Form synth. 

$02 - Note Synth. 


■Channel $00-$0F 
Gen $00-$0E 



_—\/ / vy \ 

□ 

—T—1 S 1 8 1 

000 Mode 

i i i i i i 

— i — i — i — 

Chan. NO. 

1 1 _!_ 

Gen NO. 

_!_ L _ 1 — 


bit 15 bit 0 

Stack configuration for Gen. status call: 

Gen_number:word ; generator number for status 

Error Codes: None 

Example: 

PEA $0000 ; room for Generator status 

PEA Gen.number ; Generator number 
_FFGeneratorStatus; generator status macro call 


Sound Tools ERS Rev. 1.7 June 26, 1986 12:15 PM Confidential 


page 24 




S.eiSjftuMMiBjQ.M. Function=$l2 

This calls sets up the entry point into the sound interrupt handler. 
This routine will be accessed every time an interrupt is generated by the 
DOC. The processor will be in full native mode when the sound interrupt 
handler is entered. The parameter list for a set sound IRQ vector is as 
follows: 

Set Master Sound Irq vector stack config. 

SMasterJrq: Long word ; Sound Master IRQ vector 

Error Codes: None 

Example: 

Pushlong Master.irq.vect; Set master irq vector macro 
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Emelian sS 13 

This calls sets up the entry point for a users synthesizer interrupt 
handler. When an interrupt occurs for a user defined synthesizer then 
control will be passed to the ram based synthesizer code through this 
vector. The old vector installed will passed back to the caller. This old 
vector must be preserved by the caller. If control is passed to the user 
vector and the synthesizer mode is not his, then control will passed further 
down the chain through this vector. Control will be passed through a JSL, 
therefore the user must return control through an RTL instruction. Room 
must be made on the stack for long word returned on the stack. 

Stack configuration for Set User's Sound IRQ vector. 

User_irq_vector:Longword ; New user IRQ vector 

Error Codes: None 

Example: 

Pushlong $00000000 ; make room for old vector 

Pushlong New.vector ; new vector 
_SetUserSoundlRQV ; set user sound irq vector macro 
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EESmmdllaa ^lMua. Eunstiftn—ill 4 

This call will return the status of the Free Form synthesizer sound 
playing status. If the generator specified is currently playing out a 
waveform, then the status returned to the caller will be $0000. If the 

generator is done playing then the status will be $FFFP. Room must be made 
on the stack for one word of status returned to the caller. 

Stack configuration for FFSoundDoneStatus 

Genjriumber.word ; Generator number 

Error codes: 

$0013 - Invalid generator number 

Example: 

PEA $0000 ; Make room for status 

PEA Gen.number ; Generator number to check 
^FFSoundDoneStatus; FFsynth Sound done stat macro 
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BsadJxoisieE" 

This low level routine lets an application read any DOC register. The 
routine is entered through the Jump table provided by the "GetTableAddress" 
function call. This call will return to the caller through an RTL instruction. 
After this call is made the Sound Glu register is left in register access 
mode with auto increment enabled. 

Through the generator to "oscillator" table, an application can 
assertain the setting of any register corresponding to an oscillator. 

Import: 

e - 0 ; native mode 
m - 1; 8 bit accumulator 
x - 0 ;16 bit index registers 
X - DOG register to read 


Export: 

AL - contents of register requested 
Error codes: None 


DOC register table 


REQ# 

Function 

m 

K'-M 


[jSU 

fSgl 

E3 

Bell 

KRI 

00-1F 

FREQ LOW 

PL7 


Ial3 


I3»l 

aa 

os 

FLO 


TRESTWr 


yjgjj 

|jj£ 

Ilia 

tiiy 


|g2|| 

igia 



WKtM 



KU 

mi 


Kil 

KIM 

SCWF 




|^j 



IUJ 


|££| 

80-9F 

WAVEFORM TABLE PTR 

P7 

ftiLJ 


mn 

d 

ta 

m 

d 

AO-BP 

COVTOOL 

LUJ 


LfA! 


mm 

aa 

mi 

lil 

CO-OP 

BANK SEL/TBL SIZE/RES. 

■Hi 

tui 

IO 

KOI 

mu 

lei 

EH 

nn 

bO 


gjj£| 


urn 



U M 


id 

El 

OSCILLATOR ENABLE 

MM 

MM 

ESI 


E3 

m 

d 

■a 

E2 

A/D CONVERTER 

S7 

E3 

Ef 

El 

FI 

in 

ED 

W«I 


Note: Register types are grouped into register classes. Within each 
register class, the register number for each oscillator is assigned in 
assending order. For example: the low byte of the frequency register 
for oscillator zero is register $00, the low byte of the frequency for 
oscillator number is register $01. The high frequency register for 
oscillator number zero is accessed through register number $20, 
oscillator one uses register number $21 etc... The register numbers 
are provided in the table defined above. 
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Write register ** 

The Write DOC call will write a one byte parameter to any register in 
the DOC chip. The call will be made through the jump table provided 
to the application by the tool call "Get Address". To write to an 
oscillator register corresponding to a generator we get the oscillator 
number from the oscillator table, bump it by one if we want to access 
the odd oscillator of the pair, add the base register of the specific 
register we want to access and then make the write register call 
through the Write register routine address in the jump table. This call 
will return to the caller through an RTL instruction. After this call is 
made the Sound Glu register is left in register access mode with auto 
increment enabled. Please refer to the "Note" in the Read register 
description for information on register assignments for each 
oscillator. 

Import: 

e > 0 ; native mode 
m - 1; 8 bit accumulator 
x ■ 0 ; 16 bit index registers 
AL » data to write 
X - DOC register number 

Error codes: None 


DOC register table 


REG# 

Function 

07 


p@ 

SM 

03 

02 

DU 


00-1 F 

FREQ LOW 

FL7 

FL6 

FL5 

FL4 

FL3 

FL2 

FL1 

FLO 

2Q-3F 

TRESTT - 

FH7 

TRf 

THE 

FH4 

TRJ 

FHSf 

mi 

TlTO 

. 46-SF"" 

VQXIMiT 

V7 

V$ 

VS 

V4 

‘""VT 

V2 

Vi 

“VST 

60-7F 

DATA SAfcJFL£ 

W7 

W 

ws 

W4 

“Wf 

"W2“ 

Wi 

~wr 

80-9F 

WAVEFORM TABLE PTR 

f P7 

PS 

Pf 

P4 

P 3 

P2 

PI 

PO 

AO-BF 

CONTROL 

“CRT 

CTO 

CAi 

"CTO 

IE 

M2 

Mi 

™TT~~ 

CO-OF 

BANK SEUTBL. SIZE/RES. 

X 

BS 

T2 

T1 

TO 

R2 

R1 

RO 

1 E6 

^SCICDTOHWEHRUWr... 

m 


64 

63 

1ST 

6-1 

66 

1 

El 

OSCILLATOR ENABLE! 

X 

X 

E4 

E3 

E2 

El 

EO ; 

X 

E 2 

A/D CONVERTER 

s?i 

SB 

S5j 

S4 

S3 ! 

S2 i 

SI 

SO 
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Bead—Ram^ 

This call will read any Ensoniq ram location specified by the caller. 
This call leaves the address pointer register in the Sound Glu in auto 
increment mode and in ram access mode. The call does not do any 
type of error checking on the address, or data. This call exits back to 
the caller through an RTL instruction. After this call is made the 
Sound Glu register is left in RAM access mode with auto increment 
enabled. 


Import: 

© - 0 ; native 
m a 1 ; 8 bit accumulator 
x - 0 ; 16 bit index registers 
X - Ensoniq ram address to read 

Error codes: None 
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Mills ..Ramil 

This call will writ© a on© byte value to any Ensoniq ram location 
specified. The call does not do any type of error checking on the 
address or data value to be written. This call returns to the caller 
through an RTL instruction. After this call is made the Sound Glu 
register is left in RAM access mode with auto increment enabled. 


Import: 

@ ■ 0 ; native 
m - 1 ; 8 bit accumulator 
x - 0 ; 16 bit index registers 
AL - data value to be written 
X - Ensoniq ram address to write to 

Error codes: None 
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Ftefld—Next** 

This call will read the next location pointed to by the Sound Glu 
address register. The previous call must have been a Read register, 
write register, read ram, or a write ram call for this call to work 
properly. Any of these four calls will leave the Sound Glu set to auto 
increment and pointing to DOC register or ram access mode. After the 
read is made the Sound Glu address/DOC register pointer will be 
incremented to the next location. 

Import: 

None 

Export: 

AL « data byte read 
Error codes: None 
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Write- 

This call will write one byte of data to the next DOC register or ram 
location depending on the setting of the Sound Glu control register. 
The call will write to DOC registers or ram and then increment the 
address pointer register in the Sound Glu, if the address pointer 
register was enabled for auto increment. If a Read register, read ram, 
write register or write ram call is made then that call will leave the 
Sound Glu control register in that type of access mode and with auto 
increment enabled. 

Import: 

AL - byte value to be written 
Error codes: None 
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